home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / apps / 446 / runner14 / runner.doc < prev    next >
Text File  |  1990-11-05  |  67KB  |  1,395 lines
  1. Runner -- A Desktop Alternative
  2.                                                     Warning:  This
  3. Copyright (C) 1990 by Dave Thorson                 file is about 24
  4. Version 1.40      October 12, 1990                  printed pages!
  5.  
  6.  
  7. Legalese: Runner and its associated files (except MINI_RUN.TTP) may 
  8. be distributed freely as long as all original files are included, 
  9. unchanged (except MINI_RUN.TTP).  Dave Thorson is not responsible 
  10. for any damages (lost files, loss of time, etc.) caused directly 
  11. or indirectly by this software.  Users of this software assume all 
  12. responsibility for risk.  Runner is Shareware and is NOT released 
  13. to the Public Domain; Copyright ownership remains with Dave Thorson.
  14.  
  15.  
  16.  
  17. Table O' Contents
  18.  
  19.       Intro
  20.       Shareware Stuff
  21.       New Features
  22.       Standard Features of Runner
  23.       Contents of Disk or RUNNER14.ARC
  24.       Installation
  25.       Running Runner
  26.       - File Selector Access
  27.       - Gem Menu Bar
  28.       - The Main Screen
  29.       Keyboard Equivalents
  30.       QuickKeys
  31.       Other Stuff
  32.       Products Mentioned
  33.  
  34.  
  35.  
  36. Intro
  37.  
  38. Runner is a quick, easy-to-use alternative to the standard Atari 
  39. desktop, developed for hard drive users with at least one megabyte 
  40. of memory, however it may still be of use for floppy drive users.  
  41. The new Mini-Run program makes Runner suitable for use even on 
  42. 520K systems.  Runner has only been tested on a 1040ST with TOS 
  43. 1.0 and Atari SH-204 hard drive, but should work on other systems 
  44. as well (please contact me at the address below with any bug 
  45. reports, especially for STe systems -- Thank You!)
  46.  
  47. Runner lets you manage your programs more effectively by placing 
  48. them in one or more menus; simply click on a program in a menu to 
  49. run it.  You can also assign up to eighteen QuickKeys to run your 
  50. most-used software with a single keypress, and install 
  51. applications to run by selecting their data files.  Runner is much 
  52. quicker than the desktop, and programs can be placed in menus 
  53. regardless of what drive or folder they live in.  You can group 
  54. similar programs together in the same menu, such as all games or 
  55. all graphics programs or all word processing software.
  56.  
  57. Menus can contain programs or other menus, and you decide how you 
  58. want to set them up.  Runner also provides direct access to a file 
  59. selector (if you use Universal Item Selector you may never need 
  60. the desktop again!), lets you view files or run programs not in 
  61. your menus, access desk accessories, and have a background 
  62. picture if you like (Degas Elite color-cycling supported, of 
  63. course).  All these features and more are described later, but 
  64. first....
  65.  
  66.  
  67. Shareware Stuff
  68.  
  69. I am releasing Runner as Shareware to test the market for such 
  70. programs.  Runner is NOT "Public Domain" and I reserve all rights 
  71. to the program and this documentation.  Runner has been in 
  72. development for over a year, and I use it EVERY time I use my ST 
  73. (except on self-booting games, Turtle, or the time I lost my main 
  74. hard drive partition, but that's another story....).
  75.  
  76. You are free to take Runner for a test drive on your own computer, 
  77. and see if you find it to be of value.  Whether you keep it or 
  78. not, feel free to give copies of RUNNER14.ARC (or the full set of 
  79. un-ARC'ed files) to your friends.  If you have a registered disk 
  80. you may give away a copy of everything EXCEPT MINI_RUN.TTP.  We 
  81. both save on distribution and marketing costs, and you don't get 
  82. stuck buying a program that doesn't work out as you expected after 
  83. seeing it for a few minutes in a store.
  84.  
  85. Since Runner is a copyrighted, professional program that took a 
  86. LOT of my time to develop and document, you are expected to 
  87. purchase it if you want to keep it (just like all those programs 
  88. on the wall at your local dealer!).  If you decide to keep Runner, 
  89. please send a donation of $5 to $15 to:
  90.  
  91.                Dave Thorson
  92.                3018 East Cheery Lynn Road
  93.                Phoenix, Arizona  85016
  94.  
  95. Be sure to include a return address if you need a reply, and tell 
  96. me what program you're registering so I can keep my records 
  97. straight.
  98.  
  99. I could charge more (like the "going rate" for ST software of $40 
  100. per package), but through shareware you can save on marketing and 
  101. distribution costs as well!  Shareware can make all of us come out 
  102. ahead, but only if donations are sent.  Without them, shareware 
  103. developers like myself will have no incentive to develop more 
  104. software, and you will stop seeing nifty utilities and games come 
  105. your way.
  106.  
  107.  
  108.  
  109.  
  110.       * * *  Mini-Run: Extra Shareware Incentive  * * *
  111.  
  112. An extra program, Mini-Run, will be sent to anyone contributing 
  113. $10.00 or more, as long as a disk to hold the new program is 
  114. included.  Please be sure to include a return address!  I am 
  115. making Mini-Run available only through registration because NO ONE 
  116. sent any contributions for prior shareware programs I have 
  117. released.  Runner by itself is even better than before, but Mini-
  118. Run may entice those who USE Runner to contribute for shareware.  
  119. Since you should purchase Runner anyway if continue to use it, 
  120. Mini-Run is really a freebie that's yours for the trouble of 
  121. registration!
  122.  
  123. Mini-Run can be called from Runner to run programs needing all the 
  124. memory they can get.  Runner exits and loads Mini-Run, which in 
  125. turn loads the desired program (passing any parameters or 
  126. filenames as needed for .TTP programs).  When the program exits, 
  127. Mini-Run exits and reloads Runner in its place.  Mini-Run can free 
  128. up to more than 85,000 bytes over what Runner uses for use by 
  129. another program.  It consumes under 28K of memory and less then 
  130. 8K of disk space.
  131.  
  132. Mini-Run is a very short program so it loads quickly, adding only 
  133. a second or so of delay from a hard disk.  Of course, Runner 
  134. itself is reloaded later as well, adding a bit to the delay time.  
  135. Even with these delays the process of running a program through 
  136. Mini-Run is still far quicker (and certainly more convenient) than 
  137. exiting to the desktop to run a large program, and returning to 
  138. Runner after it's done.  Please note that Mini-Run is not a mini 
  139. version of Runner; it does not provide any menus or options; it 
  140. only runs a program as directed by Runner.
  141.  
  142. In my configuration I get the following memory values from a 
  143. command line interpreter (DO-IT! from QMI) run from the desktop, 
  144. Runner 1.40 (with and without a background picture) and Mini-Run.  
  145. Memory availability on your computer will depend on how much RAM 
  146. you have, other installed programs and desk accessories, and how 
  147. you measure it!  Still, the last column shown here should be 
  148. fairly close to what you will see:
  149.  
  150.     DO_IT! run from:      Free Memory     Less than Desktop
  151.        Desktop              618,262                 0
  152.        Mini-Run             590,116            28,046
  153.        Runner 1.40 no pic   536,612            81,650
  154.        Runner 1.40 w/pic    504,612           113,650
  155.  
  156.  
  157. WARNING: Mini-Run is NOT shareware, and is registered to each user 
  158. by a serial number traceable to each copy of the program.  DO NOT 
  159. give copies of Mini-Run to friends or bulletin boards since it is 
  160. registered to YOU only.  If you give away or sell your copy, let 
  161. me know so I can update my records.
  162.  
  163.  
  164.  
  165. New Features
  166.  
  167. Runner has grown by about 12K from the last release (1.3), but 
  168. there are lots of new features and a few fixes in version 1.40:
  169.  
  170. * Support for Mini-Run is main addition.  Programs can be set in 
  171. the description dialog box to always use Mini-Run, or you can 
  172. force a program to be run from Mini-Run as you select it.
  173.  
  174. * A separate text palette is available (and remembered when saving 
  175. a RUNNER.CFG file).  This lets you select the colors you like best 
  176. for reading text, regardless of preferences for running programs 
  177. or other Runner background colors.
  178.  
  179. * All color palettes can now be changed from within Runner.
  180.  
  181. * QuickKeys can be assigned to any program in your Runner menu 
  182. lists to let you run that program by pressing the assigned 
  183. QuickKey.  QuickKey assignments can be listed like a Runner menu.  
  184.  
  185. * Ability to restore a dropped program or menu to another place in 
  186. your menu structure.
  187.  
  188. * All Adds and Restores are now sorted alphabetically, with menus 
  189. at the top of each list (to sort older menus, drop and restore any 
  190. names out of order).
  191.  
  192. * On-line help for keyboard commands is available (this is done by 
  193. viewing a disk file to save memory, but the file is small and is 
  194. quickly accessed by pressing the HELP key).
  195.  
  196. * 12-hour time, 24-hour time or date can be displayed on main menu 
  197. screen.  The Backspace key switches between them.
  198.  
  199. * File selector can now be accessed by pressing SPACE (since the 
  200. HELP key is now used for, would you believe it, Help).
  201.  
  202. * Mouse clicks in File View can now move forward, backward 
  203. or exit.
  204.  
  205. * Smart mouse click checking lets you consistently register BOTH 
  206. buttons (in the few places BOTH are needed) by pressing the second 
  207. any time before releasing the first.  No more need to violate of 
  208. the Laws of Physics by trying to press both buttons at EXACTLY the 
  209. same time.
  210.  
  211. * New RUNNER.CFG file format is not usable by older versions of 
  212. Runner, but RCONVERT.PRG is included to convert older .CFG files 
  213. to the new format with NO loss of information.
  214.  
  215. * You now stay in the file selector until you select Cancel, 
  216. rather than exiting any time a program is run.
  217.  
  218. * Palette checking for background/text color distinction has been 
  219. removed.  It is now possible to make text invisible if you want, 
  220. but you also have easy access to palette changes to fix this 
  221. problem.  This also fixes the problem where text colors were 
  222. sometimes changed to be less readable than when they started.
  223.  
  224. * Several routines built in to GFA BASIC 3.x now replace the ones 
  225. I wrote in GFA BASIC 2.x, to take less memory and provide greater 
  226. speed in places.
  227.  
  228. * The keyboard commands for selecting color palettes have changed 
  229. to N-iNitial, K-desKtop, G-backGround and T-Text.
  230.  
  231. * Menu location (left and right) and menu background (type of 
  232. space blanked out behind menu lists) are now adjustable and are 
  233. saved for each background picture as well as for a single no-
  234. background setup.  Changed picture palettes are also saved for 
  235. each picture.  These adjustments can be made within Runner.
  236.  
  237. * Degas Elite color-cycling animation is now supported, all four 
  238. channels of it.
  239.  
  240. * H key now hides all text, leaving the background picture (or 
  241. blank screen) in full view.  Z key hides picture AND text.
  242.  
  243. * Support for remembering the color changes made by a program run 
  244. from runner is disabled; the meaning of that flag in the 
  245. description box has been changed to force Mini-Run to run the 
  246. program.  Check the description dialog box for any programs where 
  247. you enabled "Keep Colors".
  248.  
  249. * .APP programs are now supported - maybe.  I'm not sure what 
  250. these are (my TOS 1.0 desktop doesn't know about them) but have 
  251. been told they are set up just like .PRG files.  Runner treats 
  252. them as .PRG files.  If this doesn't work for some reason, write 
  253. me and let me know.
  254.  
  255.  
  256.  
  257.  
  258. Standard Features of Runner
  259.  
  260. * Runs in ANY resolution.
  261.  
  262. * Programs can be run without worrying about what folder or disk 
  263. they're physically stored in.  Runner switches to the program's 
  264. disk and folder automatically (usually -- see details below).
  265.  
  266. * Tos-Takes-Parameters (.TTP) programs normally require a command 
  267. line or parameters to be entered; Runner prompts you for this. 
  268. Command lines can be longer than the 20 provided for in the 
  269. desktop's dialogue box.
  270.  
  271. * Lets you include up to 15 programs per menu; any of these 
  272. programs can be run with the click of a mouse.  No more waiting 
  273. for the desktop to redraw: on exiting a program you are returned 
  274. immediately to Runner's screen.  Programs are included by simply 
  275. selecting them from a file selector box, regardless of drive or 
  276. folder.  Additional information may be entered about the program 
  277. to customize how it will work and what it is called in menu lists.
  278.  
  279. * Any of the 15 programs in a menu can be a menu itself, giving 
  280. you access to 15 more programs or menus by clicking on the menu.  
  281.  
  282. * Menus can be nested up to 15 levels deep (although why you would 
  283. ever need more than three levels I don't know....).  For example, 
  284. on the top level menu you might have several programs and another 
  285. menu named Graphics.  Clicking on Graphics displays a new menu 
  286. containing more menus called Paint Programs, Drafting, Slideshows 
  287. and Conversions.  Clicking on Paint Programs reveals Degas Elite, 
  288. Colorburst 3000 and Spectrum 512.  This nesting capability of 
  289. Runner means you can logically arrange your programs for quickest 
  290. access.  With only 3 menu levels, you could access up to 3,375 
  291. programs, more than will fit on any hard disk I know of.
  292.  
  293. * Programs and menus are listed using descriptions rather than 
  294. filenames.  The default description for Degas Elite is "Degelite", 
  295. the original program name minus the .PRG extension.  If you like 
  296. "Degelite" as a description, fine, or you can change it to the 
  297. more readable "Degas Elite".  Descriptions can be up to 20 
  298. characters.  Runner tries to "beautify" filenames such as 
  299. "CAD3D.PRG" to the (sometimes) more readable form of "Cad 3 D", 
  300. or "SHOW_PIC.TTP" to "Show Pic", but you can still change the 
  301. description Runner provides to whatever you like.
  302.  
  303. * Programs and menus can be forced to appear only in certain 
  304. resolutions.  You don't need to see Spectrum 512 in the list when 
  305. using a monochrome monitor, for example.
  306.  
  307. * Runner can force the screen resolution on a color monitor from 
  308. low to medium or from medium to low, and this is remembered 
  309. independently for each listed program.  While GEM does not always 
  310. keep up with this trickery, it does allow you to run some programs 
  311. successfully (or perhaps well enough to gain benefit) from the 
  312. wrong resolution.  Mini-Run supports these forced resolution 
  313. changes as well.
  314.  
  315. * Programs and menus can be added, dropped, restored or changed at 
  316. any time.
  317.  
  318. * Access to a file selector is always a mouse click or keypress 
  319. away.  If a selected file is a program, Runner will run it as if 
  320. it were listed in a menu.  Otherwise, Runner will display the file 
  321. on the screen.  "Funny" characters are stripped out, and the text 
  322. is wrapped at the right edge of the screen, word-processor style.  
  323. The GEM Desktop has trouble displaying files in low res that are 
  324. more than 40 characters wide; it breaks them at the 40th column, 
  325. usually in the middle of a word, and loses the line count so that 
  326. up to forty half-lines may scroll off the screen without being 
  327. read.  To make matters worse, a text file in the wrong format 
  328. (such as from ST Writer) just keeps scrolling on by.  Runner's 
  329. file view fixes all these problems, and lets you move backward 
  330. through the a file as well.
  331.  
  332. * Programs can be "installed" so that clicking on one of their 
  333. document or data files in the file selector will cause the program 
  334. to be run.  The name of the data file is passed to the program so 
  335. it can be automatically loaded if the program supports this.
  336.  
  337. * If you use an advanced file selector like Universal Item 
  338. Selector (UIS III) from Application and Design Software, all of its 
  339. capabilities will be available.  UIS III (from Application and 
  340. Design Software), for example, lets you rename, copy, delete, 
  341. print and move files, as well as format disks.  You will not need 
  342. to exit to the desktop for these functions.
  343.  
  344. * Runner will use any Degas-compatible picture as a background 
  345. display.  Pictures for the current resolution can be loaded on 
  346. startup or after Runner is running.  If memory is short, a picture 
  347. can be unloaded to free up 32,000 bytes.  Template "guide" files 
  348. are included to help you design your own background scenes.
  349.  
  350. * Desk Accessories are also available while in Runner.  Due to 
  351. some insurmountable quirks in GFA BASIC (or is it GEM?), the 
  352. accessory interface is a bit strange but it's there....
  353.  
  354. * Runner's menu lists can be saved any time, loaded on startup or 
  355. loaded from within Runner.  You can have different "configuration" 
  356. files (containing different menu lists and color selections) for 
  357. different purposes, if desired.
  358.  
  359. * The palette used for running programs can be selected to be the 
  360. desktop colors, the colors last saved in RUNNER.CFG, colors used 
  361. for viewing text files, or the colors of whatever picture file is 
  362. loaded at the time.  This palette selection does not affect the 
  363. displayed picture (unless you want it to).
  364.  
  365. * <[This feature removed in version 1.30:  Runner will not permit a 
  366. bad selection of colors to make text unreadable.  If a picture 
  367. file is loaded that would make the text and background colors too 
  368. close, Runner changes the text color.]> -- Since Runner lets you 
  369. change colors easily, if text becomes unreadable you can fix it 
  370. yourself (hold down Control or Alternate and press G, then press 0 
  371. on the keypad, and R, G or B until you can read the text -- color 
  372. changes are described in more detail later).
  373.  
  374.  
  375.  
  376.  
  377. Contents
  378.  
  379. The RUNNER14.ARC file or Runner disk contains the following files:
  380.  
  381.      RUNNER.PRG - the Runner program file
  382.     READ_ME.TXT - quick start notes for the impatient
  383.      RUNNER.HLP - displayed by pressing the HELP key from Runner's
  384.                   main menu; you may want to print it as well
  385.      RUNNER.DOC - the file you are reading
  386.      RUNNER.PI1 - sample picture file for low resolution
  387.      RUNNER.PI2 - sample picture file for medium resolution
  388.      RUNNER.PI3 - sample picture file for high resolution
  389.      RUNNER.CFG - sample configuration file (note: unless your
  390.                   hard disk is set up exactly like mine, you 
  391.                   cannot access programs from the menus in this
  392.                   file -- it's just included so you can get an
  393.                   idea how I use Runner every day)
  394.      GUIDE.PI1  - Template for designing low res pictures
  395.      GUIDE.PI2  - Template for designing medium res pictures
  396.      GUIDE.PI3  - Template for designing high res pictures
  397.   MINI_RUN.TTP  - Only for registered users who contribute at 
  398.                   least $10.00 and a returnable disk
  399.   RCONVERT.PRG  - Converts older RUNNER.CFG files for use with 
  400.                   newer versions (1.40 or higher) of Runner
  401.       WORMS.PI1 - Another background picture for low res to show
  402.                   a rather extreme use of animation
  403.       WORMS.CF1 - Picture configuration file loaded with WORMS.PI1
  404.  
  405.  
  406.  
  407.  
  408. Installation
  409.  
  410. Runner can be installed in a variety of ways.  The RUNNER.PRG file 
  411. can go almost anywhere except an AUTO folder.  When you start 
  412. Runner, it searches for a file called RUNNER.CFG (use mine as an 
  413. example, or create a new one from scratch within Runner using the 
  414. Save command).  The search sequence for RUNNER.CFG is:
  415.  
  416. 1. in the current directory (folder), where RUNNER.PRG is
  417. 2. in the root directory (outside all folders) of the current disk 
  418.    (the disk RUNNER.PRG was loaded from)
  419. 3. in a folder in the root directory of the current disk called 
  420.    Runner (ex: D:\RUNNER\)
  421.  
  422. If RUNNER.CFG is found, that directory (folder) is assumed to be 
  423. Runner's "home" directory.  Whenever you save or load a 
  424. configuration file or load a picture file, Runner takes you to 
  425. that directory by default.  If RUNNER.CFG is NOT found, then the 
  426. root directory of the current drive becomes Runner's home 
  427. directory.  
  428.  
  429. If you have MINI_RUN.TTP, it MUST also be placed in this home 
  430. directory.  It's a small file, so don't worry.  
  431.  
  432. After loading (or failing to find) RUNNER.CFG, Runner next looks 
  433. for a picture file to load from Runner's home directory.  The 
  434. names for these auto-loading picture files are:
  435.  
  436.      RUNNER.PI1 for low resolution
  437.      RUNNER.PI2 for medium resolution
  438.      RUNNER.PI3 for high resolution
  439.  
  440. Use the pictures included with Runner (who knows what possessed me 
  441. to paint them....), or use the guide pictures 
  442. to create your own.  The names above are used for automatically 
  443. loading a background picture.  If Runner cannot find the 
  444. appropriate file for the current resolution, no picture is loaded.  
  445. Note: if you hold down the Alternate or Control key when Runner 
  446. starts, Runner will not look for a picture file to load.  Any 
  447. Degas-compatible (uncompressed) picture can be loaded later from 
  448. within Runner.
  449.  
  450.  
  451. I have Runner set up for my system as follows:
  452.  
  453.    Top (root) directory
  454.        of drive D:            Runner's "home" directory:
  455.  
  456.       D:\RUNNER.PRG              D:\RUNNER\RUNNER.CFG
  457.                                  D:\RUNNER\RUNNER.PI1
  458.                                  D:\RUNNER\RUNNER.PI2
  459.                                  D:\RUNNER\RUNNER.PI3
  460.                                  D:\RUNNER\RUNNER.HLP
  461.                                  D:\RUNNER\MINI_RUN.TTP
  462.  
  463. RUNNER.PRG is in the root directory of drive D: (outside of any 
  464. folders).  RUNNER.CFG and the picture files RUNNER.PIx are stored 
  465. in a folder called Runner which appears in the window when drive 
  466. D: is opened from the desktop (it's a folder within the root 
  467. directory of drive D:).  MINI_RUN.TTP is also in this directory.  
  468. D:\RUNNER\ is considered to be Runner's home directory in my 
  469. setup.
  470.  
  471. There are lots of options.  You may want to install RUNNER.PRG in 
  472. the Install Applications menu from the desktop, and set it to 
  473. start Runner for filetypes of ".RUN".  Then put a file called 
  474. RUNNER.RUN in any directory where you want to run Runner, and it 
  475. can be started by clicking on RUNNER.RUN.  If RUNNER.PRG is not in 
  476. the root directory of the drive you are using, you may want to 
  477. edit the DESKTOP.INF file.  Change the line that says RUNNER.PRG 
  478. to include the full path and drive for the program, such as 
  479. D:\UTILITY\RUNNER\RUNNER.PRG.  This is something GEM should do for 
  480. you, but it's not a difficult fix to make.  Be sure when saving 
  481. DESKTOP.INF to save it with Word Processing mode OFF or as an 
  482. ASCII file.  And make a backup copy of DESKTOP.INF just to be 
  483. safe.  This change will not be available to you until you until 
  484. you reset your computer.
  485.  
  486. For floppy disks, you may want a Runner disk with all the Runner 
  487. files in the root directory.  This disk must be in the drive 
  488. whenever you ask for help (or else your help request will be 
  489. ignored).  On a two drive system you can keep MINI_RUN.TTP in the 
  490. drive where Runner started, and put application disks in drive B.  
  491. Or, place Mini-Run in the root directory of your application disks 
  492. in drive A (assuming you started Runner so that RUNNER.CFG was in 
  493. the root directory of drive A).  Then Mini-Run will be found and 
  494. can load your application.  Be sure to replace your Runner disk in 
  495. drive A before exiting the application.  Of course, if you don't 
  496. use Mini-Run then you don't need to mess with any of this....
  497.  
  498. I use HeadStart (version 1.1) from Codehead Software to start 
  499. Runner whenever my ST is turned on.  A file called HEADSTRT.DAT 
  500. goes in the root directory of my C: drive, and HEADST11.PRG is in 
  501. the AUTO folder of the C: drive.  HEADSTRT.DAT contains the line:
  502.  
  503.      D:\RUNNER.PRG
  504.  
  505. HeadStart reads its data file, and loads Runner after the desktop 
  506. appears.  I no longer need to open any desktop windows at all!
  507.  
  508. To make life simple while you're first trying Runner, just put all 
  509. the Runner files in the same directory (folder) or in the root 
  510. directory of some floppy disk or hard drive partition.  Since 
  511. Runner first checks the directory it was started from for these 
  512. files, it will find them!
  513.  
  514. The only  * required *  files needed are RUNNER.PRG and your 
  515. RUNNER.CFG file, although you may want the RUNNER.HLP file for on-
  516. line help, MINI_RUN.TTP to save space for larger programs, and 
  517. your favorite background picture files....
  518.  
  519.  
  520. At this point, you should go ahead and start Runner.  I'll assume 
  521. you are not using my sample RUNNER.CFG file, although it won't get 
  522. in the way if you are.
  523.  
  524.  
  525.  
  526.  
  527.  
  528. Running Runner
  529.  
  530. Double-click on RUNNER.PRG to start the program.  Hold down the 
  531. Alternate key as Runner starts if you do not want it to load a 
  532. picture file.  Runner will determine where its "home" directory 
  533. is, and load a RUNNER.CFG file or background picture as 
  534. appropriate.
  535.  
  536. In the main screen you will see the program title ("Mr. Dave's 
  537. Runner" - don't worry, you can change it!) and a line that reads 
  538. "Exit Runner".  Click on this line to exit the program; an alert 
  539. box will pop up asking you if you do indeed wish to exit.  For 
  540. now, click on Runner to return to the program.
  541.  
  542. NOTE: Many of the functions in Runner have an alternate way to use 
  543. them.  To access these alternate functions (as described in lots 
  544. of places below), hold down the Alternate key when pressing the 
  545. appropriate key or mouse button.  Then release the Alternate key.  
  546. The Control key can always be used instead of the Alternate key if 
  547. that's easier for you to reach.  The Shift keys are NEVER needed 
  548. or used except when accessing the alternate set of QuickKeys.
  549.  
  550.  
  551.  
  552. File Selector Access
  553.  
  554. Click on the title line to access a file selector box.  This can 
  555. be handy if you want to see what's on a disk, since a file 
  556. selector displays the filenames and folders.  This can be even 
  557. handier if you're using Universal Item Selector, since now you 
  558. have access to Copy, Move, Delete, Rename, Format and Print 
  559. capabilities, among others.  If you click on Cancel or OK without 
  560. selecting a file, the file selector goes away and you're back in 
  561. Runner.  Note: you can also access a file selector by pressing the 
  562. SPACE bar on the keyboard.
  563.  
  564. If, from the file selector, you select a program file (ending in 
  565. .PRG, .TTP or .TOS), Runner will attempt to run that program.  
  566. Runner asks you for a command line for .TTP programs.  When you 
  567. exit the program, the item selector will appear again.  Hold down 
  568. Alternate or Control to skip the file selector and return straight 
  569. back to Runner's menu screen.
  570.  
  571. If you select any other file, Runner will display it on the screen 
  572. as text (a nice enhancement would be to display graphics files as 
  573. pictures, but that's a lot of extra overhead in the program, 
  574. especially considering all the different picture types and 
  575. compression methods in use).  Press the left mouse button, down 
  576. arrow, or the SPACE key to continue after the screen fills.  Press 
  577. the right mouse button, up arrow, or the B (as in Back) key to go 
  578. back to previous screens.  Press both mouse buttons, Return, Undo 
  579. or Q to  quit the file view at any time.  When you quit the file 
  580. view, the file selector will appear again.  Hold down Alternate or 
  581. Control when quitting to skip the file selector and return to 
  582. Runner's menu screen.
  583.  
  584. If you want to run a program with Mini-Run from the file selector 
  585. you have two choices.  Press the Esc key before going to the file 
  586. selector.  "MINI_RUN" will replace the time or date displayed in 
  587. the upper right screen corner (press Esc again to turn this off 
  588. and disable Mini-Run).  Then, the next program selected will be 
  589. run by Mini-Run.  The other method is to hold down Alternate or 
  590. Control when selecting the program.  Hold one of these keys until 
  591. the program begins to load from the disk.
  592.  
  593. If you click on a data file for an installed application 
  594. (described below), that application will load and use the selected 
  595. file.  For example, clicking on HI_MOM.DOC in the file selector 
  596. would load Word Writer on my computer, and my letter to Mom would 
  597. be loaded into Word Writer for me.  To simply view a data file 
  598. that would otherwise cause its application to load, hold down 
  599. Alternate or Control when selecting it.  Since this bypasses an 
  600. installed application there is no way to force Mini-Run to run an 
  601. installed application with Alternate or Control; you'll have to 
  602. press Esc as mentioned above.
  603.  
  604.  
  605.  
  606.  
  607. GEM Menu Bar
  608.  
  609. That's it for the file selector; but there are lots of goodies in 
  610. the menu bar at the top of the screen.  Notice that when you move 
  611. the mouse into the menu bar, the arrow turns into a pointing hand.  
  612. While the hand is visible, you cannot select anything EXCEPT 
  613. what's in the GEM menus.  Press the left mouse button to change 
  614. the hand back to an arrow.
  615.  
  616.  
  617. Desk - About....
  618.  
  619. Under Desk you will find About....; click on it to see my name, 
  620. Runner's version number, and the approximate amount of free RAM 
  621. (Runner uses lots of stuff internally that gets cleared before a 
  622. program is run, and there's no good way to tell exactly how much 
  623. space will be available to the program -- this estimate may be off 
  624. by several K bytes).
  625.  
  626.  
  627. Desk - Use accessories
  628.  
  629. Click on Use Accessories to get to any of the shaded desk 
  630. accessories in the Desk menu.  The screen will clear and a single 
  631. Desk menu will appear.  Accessories can be freely used now, 
  632. although many of them leave behind "holes" in the screen 
  633. (depending on your color choices).  Under the Desk menu, the 
  634. second item is now called End Accessories.  Click on this to quit 
  635. using accessories and get back to the Runner program.
  636.  
  637.  
  638.  
  639.  
  640. File
  641.  
  642. The File menu contains Load, Save, Install, Background and Fix 
  643. options.  Note that Quit is not available here as it is in most 
  644. File menus.  Exit Runner is available from the top level Runner 
  645. menu or by pressing the Undo key.
  646.  
  647.  
  648. File - Load config
  649.  
  650. Load lets you load RUNNER.CFG.  It starts in Runner's home 
  651. directory, but you can change to another directory or load a 
  652. different configuration file from the file selector box that 
  653. appears.  There is no warning to save any changes you may have 
  654. made to the configuration in memory, so be careful.  Loading a new 
  655. .CFG file will replace anything already in memory except the 
  656. picture.  Clicking on Cancel in the file selector box will stop 
  657. the load operation.
  658.  
  659.  
  660. File - Save config
  661.  
  662. Save lets you preserve your current setup for the next time you 
  663. run Runner.  Program configurations and descriptions, menus, menu 
  664. structures, initial and text color palettes and the main title are 
  665. all saved in the configuration file (as well as lots of other 
  666. stuff).  Use RUNNER.CFG if you want that configuration to be auto-
  667. loaded the next time you start Runner, or give it another name if 
  668. you choose.  "File - Load config" lists all files in Runner's home 
  669. directory that end with ".CFG", so you should use this extension 
  670. for any configuration files you save.  Clicking on Cancel in the 
  671. file selector box will stop the save operation.
  672.  
  673. Note: File - Save may also create a picture configuration file 
  674. recording any changes in menu list position, menu space attributes 
  675. (how much of the underlying background picture is blanked out by 
  676. spaces around the menu), and background picture palette if you 
  677. have changed any of these since loading the picture.  These files 
  678. have the same name as the current picture in memory, but with a 
  679. file extension of .CF1, .CF2 or .CF3 to match the picture's 
  680. resolution.  If you loaded MOUNTAIN.PI1, File - Save might create 
  681. a MOUNTAIN.CF1 picture configuration file.  If you want to force 
  682. the save of a picture configuration file without updating the 
  683. RUNNER.CFG file on your disk, hold down Alternate or Control when 
  684. selecting any .CFG file.
  685.  
  686. Safety Feature: Both Runner configuration and picture 
  687. configuration files are saved using this procedure:
  688.  
  689.   1. Create ".TMP" filename (ex: MYCONFIG.CFG becomes MYCONFIG.TMP)
  690.   2. Write file to disk using ".TMP" filename
  691.   3. If successful:
  692.   3a. Delete any file matching desired save name (ex: MYCONFIG.CFG)
  693.   3b. Rename ".TMP" file to desired name (ex: MYCONFIG.CFG)
  694.  
  695. If a save is NOT successful (disk full or other problems) then 
  696. your original file is not changed in any way.  You may want to 
  697. erase any ".TMP" files Runner creates, although they won't cause 
  698. any problems for Runner.  There is no good way to check disk space 
  699. requirements for saving a file without a lot of extra code in 
  700. memory.  If you try to save a file and fail, you can always return 
  701. to Runner and try again to save the file to a different disk.
  702.  
  703.  
  704. File - Install apps
  705.  
  706. Install lets you install applications in Runner, similar to the 
  707. GEM desktop's Install Applications concept.  Up to 16 applications 
  708. can be installed so that they can be run by clicking on a data or 
  709. document file they use from within the file selector.  As 
  710. described earlier, you might install Word Writer to be triggered 
  711. by any file ending with ".DOC".  Then, by clicking on "HI_MOM.DOC" 
  712. in the file selector, Word Writer will be run and will 
  713. automatically load your letter to mom for editing or printing.  
  714. Some programs do not expect to get a filename so they won't load 
  715. the selected file; they can still be started by clicking on a file 
  716. with an extension you specify.
  717.  
  718. The install screen lists all 16 applications.  Press a letter key 
  719. from A to P to select one to add or change.  Enter the file 
  720. extension you want recognized, such as "DOC" or "ARC" or "LZH".  
  721. Then a file selector lets you tell which program will handle that 
  722. type of file.  Hold down Alternate or Control when selecting the 
  723. program to force it to be run from Mini-Run every time it's 
  724. needed.  Press any mouse button or key (besides A through P) to 
  725. exit the install screen.  The installed application list is stored 
  726. in RUNNER.CFG.
  727.  
  728. If you want an installed program to always be run from Mini-Run, 
  729. simply hold down Alternate or Control when you select the 
  730. application from the file selector in the Install screen.  The 
  731. symbol "(M)" appears next to all applications that will use Mini-
  732. Run.
  733.  
  734. One more note on the Install screen - you can enter wildcards in 
  735. file extensions to trigger an application from more than one file 
  736. type.  A "?" replaces one character, and a "*" replaces all 
  737. characters from that spot to the end.  For example, "PI?" can mean 
  738. "PI1", "PI2" and "PI3" (but also "PIC").  Don't get carried away 
  739. with using "P*" to represent all picture files; it may seem 
  740. reasonable but then your paint program will also be started 
  741. whenever you select any .PRG file from the file selector!  You can 
  742. install the same application more than once, so "PI?" and "PC?" 
  743. will get all Degas-compatible pictures.  Just install your paint 
  744. program twice, once with each extension.
  745.  
  746.  
  747. File - Background
  748.  
  749. Background lets you load and unload pictures.  If no picture is in 
  750. memory, a file selector will appear showing all the .PIx files for 
  751. the current resolution in Runner's home directory.  Use the file 
  752. selector box to move to another disk or directory if needed.  
  753. Select the picture you want, and it will become the background for 
  754. Runner's screen.  If a picture is already displayed when you 
  755. select Background, you will be asked if you want to load another 
  756. picture or unload the one you've got.  Unloading a picture frees 
  757. 32,000 bytes of memory for larger applications.  Loading a new 
  758. picture replaces the old one and brings in the color palette for 
  759. the new picture.  Clicking on Cancel from the file selector box 
  760. will stop the picture load operation and leave the current picture 
  761. (if any) in memory.  If a picture has an associated picture 
  762. configuration file (.CF1, .CF2 or .CF3 extension), it will be 
  763. loaded along with the picture.
  764.  
  765. Note that if the color registers used for the background color and 
  766. the text color have color values that are too close, you may not 
  767. be able to read text on the screen.  You'll need to change colors.  
  768. This is described in detail below, but for now hold Control (or 
  769. Alternate) and press G to make the background palette the current 
  770. colors.  Press 0 on the numeric keypad to select the background 
  771. color, and press R, G or B to change the background colors.  Now 
  772. you should be able to see what you are doing.  You'll need to 
  773. change the picture's palette with a paint program to make the 
  774. change permanent.
  775.  
  776.  
  777. File - Fix (re-run)
  778.  
  779. This command lets you "fix" Runner when an unruly application 
  780. messes it up.  Fix simply reloads Runner, but this is often enough 
  781. to solve most problems.  For example, after running ST Writer, 
  782. Runner has serious problems with clearing inverse video colors and 
  783. restoring what the mouse covered.  After spending hours searching 
  784. for a solution (to absolutely no avail) I realized that other 
  785. applications might cause different problems, and that Runner's 
  786. size would grow considerably if code had to be added to handle any 
  787. condition.  Fix is clean and simple....   Running a program 
  788. through Mini-Run should also isolate most problems from Runner.  
  789. Lest you think that these problems are common, I should point out 
  790. that the ONLY two problem programs I've seen are ST Writer and 
  791. Word Writer (which forgets to clear its buttons from memory - they 
  792. get redrawn even after exiting Word Writer).  I regularly use GFA 
  793. BASIC, Laser C, Degas Elite, Spectrum 512, DO-IT!, Turbo ST, Atari 
  794. Planetarium, Flash, Real Time, Fontrix, and several other programs 
  795. and games with no problems!  The only programs I've found that do 
  796. not work with Runner, other than self-booting games, are Diablo 
  797. and MidiDraw from Intelligent Music (these don't seem to work any 
  798. time my Atari SH-204 hard drive is running, whether or not Runner 
  799. is in use).
  800.  
  801.  
  802.  
  803. Menus
  804.  
  805. The Menus menu contains add Program, add Menu, Drop, Change, 
  806. Restore and Show quickkeys.  This is where you change Runner's 
  807. program menus to contain the programs you use most often.
  808.  
  809.  
  810. Menus - add Program
  811.  
  812. Add Program displays a file selector box.  Select a .PRG, .APP, 
  813. .TTP or .TOS file from any disk or directory, or select cancel if 
  814. you decide not to add a new program after all.  Note that if you 
  815. already have fifteen programs or menu names in the list displayed 
  816. on the screen, Add Program will do nothing.  In this case you must 
  817. first remove something, or move to another menu.  If you select a 
  818. program file, a dialogue box will appear with a default program 
  819. name and other default settings for the program.  Use the 
  820. BACKSPACE key, letters, numbers, spaces or other symbols to change 
  821. the description if you want; this is what you'll see from Runner's 
  822. screen.  The Esc key erases the description.  If no description is 
  823. entered, the default name will be used.  Use the left mouse button 
  824. to click on the options in the box.  They are:
  825.  
  826.      Low Res - a check mark means the program will appear on menus
  827.           while in low resolution.
  828.  
  829.      Med Res - same as Low Res, but for Medium Resolution.
  830.  
  831.      High Res - same as Low Res, but for High Resolution (mono).
  832.  
  833.      Use Mini-Run - whenever this program is run, Mini-Run will be 
  834.           activated.  For large programs like REAL TIME, CAD 3D, or 
  835.           desktop publishing, you may always want to use Mini-Run.
  836.  
  837.      Hold Screen - this is the default for .TTP programs.  If a 
  838.           check mark appears here, Runner will prompt for a key 
  839.           press or mouse button click before clearing the screen 
  840.           and returning to Runner's screen when a program exits.
  841.  
  842.      Low or Med - the check mark always appears here because one 
  843.           of these options is always selected.  Clicking here 
  844.           cycles from "Low or Med" (program will run in either low 
  845.           or medium res, whatever mode the computer is in),
  846.           "Low to Med" (forces programs in low resolution to run in 
  847.           a medium res screen), to "Med to Low" (forces programs in 
  848.           medium res to run in a low res screen) and back to
  849.           "Low or Med".  This is a way to fool GEM into displaying 
  850.           the desired resolution, but the mouse control or other 
  851.           things may not be what you expect.  These options can be 
  852.           useful, but try them to be sure they work for a given 
  853.           program.
  854.  
  855. When you have the dialogue box set the way you want it, press 
  856. RETURN or click the right mouse button.  Any changes will be 
  857. remembered.  Note that there is no UNDO capability; there are not 
  858. that many options and they're easy to fix if you should mix things 
  859. up.  Your program will now appear in Runner's menu (if you 
  860. configured it to run in the current resolution).  You cannot 
  861. prevent a program from appearing in all three resolutions at the 
  862. same time; Runner may surprise you with some clicks on the 
  863. resolution options because it wants at least one resolution 
  864. available.  Note: if you disable a program from the resolution 
  865. you're currently using, it will NOT appear on the menu when you 
  866. exit the Description dialog box.  Press the Tab key to show items 
  867. from other resolutions; press Tab again to hide them.
  868.  
  869.  
  870. Menus - add Menu
  871.  
  872. Adding a menu works the same as adding a program, except that you 
  873. skip the file selection process and go straight to the same 
  874. dialogue box.  The Hold Screen, Use Mini-Run and resolution 
  875. forcing options don't have any effect on Menus, but to save memory 
  876. the same dialogue box is used for both menus and programs.  Don't 
  877. worry about it.  You CAN select the resolution(s) for which a menu 
  878. should be available.  If you leave the description empty, no menu 
  879. is added.  As for programs, if you already have fifteen programs 
  880. or menus displayed, Add Menu has no effect.  Menus can be nested, 
  881. that is, a menu list can contain menus which can, in turn, contain 
  882. more menus.  Simply click on Add Menu while you're inside another 
  883. menu, and the new menu will be nested inside the current menu.  
  884. Menus can be nested in this fashion up to maximum of fifteen 
  885. levels deep, probably more than you could ever use.  Since one 
  886. purpose of Runner is to avoid all the folder searching that goes 
  887. on from the Desktop, you may want to use as few menus as 
  888. necessary.  This is still easier than on the desktop since you're 
  889. only dealing with program names and don't need a separate menu to 
  890. group together all the .RSC, data, font files and anything else 
  891. needed for a program.  Folders continue to do this quite well.
  892.  
  893.  
  894. Menus - Change
  895.  
  896. Change lets you change the configuration for any program or menu.  
  897. When you click on Change, a prompt at the top of the screen tells 
  898. you to select a menu or program that you want to change.  Use the 
  899. mouse to pick a program or menu, and the same dialogue box appears 
  900. that you used when the program or menu was first added.  Change 
  901. the description or any of the other options, and press Return or 
  902. the right mouse button when finished.  When the "Select to Change" 
  903. prompt is visible, clicking the left mouse button away from the 
  904. programs, menus and GEM menu bar will exit the change prompt.
  905.  
  906. If you select the title line for Change, you can change Runner's 
  907. main title.  This title only appears on Runner's top level menu 
  908. (the one you see when Runner starts).  On lower level menus the 
  909. name of the menu appears instead.  Click on any of these titles to 
  910. change the main title.  The new title is saved to disk when you 
  911. save a configuration file.  Add your own name or whatever you 
  912. like!
  913.  
  914. It's possible to change (and Drop - see the next section on 
  915. Menus - Drop) programs or menus that appear only in a 
  916. resolution you're not in at the time.  Press the Tab key to show 
  917. ALL programs and menus; a "registered" symbol ("R" inside a 
  918. circle) appears in front of anything you normally can't see in the 
  919. current resolution.  These menus or programs can now be changed or 
  920. dropped normally.  Press Tab again to hide items from the wrong 
  921. resolution.
  922.  
  923.  
  924. Menus - Drop
  925.  
  926. Drop lets you delete a program or menu from the display.  It DOES 
  927. NOT change the programs on disk.  Drop is similar to Change.  
  928. Click on Drop and a prompt appears telling you to select a program 
  929. or menu to drop.  Click on the program or menu you no longer want 
  930. in the list.  If you drop a menu, EVERYTHING in the menu is droped 
  931. as well -- all its programs and menus.  Remember that none of your 
  932. changes are permanent until you save this new configuration back 
  933. to disk with the Save command in the Files menu.  The Tab key (see 
  934. above section on Menus - Change) is also useful with Drop.
  935.  
  936.  
  937. Menus - Restore
  938.  
  939. When you Drop a menu or program name from a menu list, it goes 
  940. into a "drop buffer".  Selecting Restore brings it back, and 
  941. inserts it into whatever menu list you're looking at.  This lets 
  942. you move menus or programs around in your lists, or recall 
  943. something tou dropped by accident.  Drop and Restore can also be 
  944. used to place an old RUNNER.CFG menu list in alphabetic order: 
  945. drop items out of order and restore them to the same menu.  They 
  946. will be inserted in the correct spot.  Note that the contents of a 
  947. menu that is dropped are also restored with it, so whole menus can 
  948. be moved wherever you like.  Also note: there is only one drop 
  949. buffer; when you drop a second item it clears the old information 
  950. from the drop buffer first.
  951.  
  952.  
  953. Menus - QuickKeys show/hide
  954.  
  955. This option lets you display a list of QuickKeys assignments 
  956. instead of the normal Runner menus.  Programs in the list can be 
  957. selected for running as usual, and the Change option works also.  
  958. Programs Dropped from the QuickKeys list are not dropped from your 
  959. normal menus, they are simply deassigned from the corresponding 
  960. QuickKey.  Restore is disabled in the QuickKeys list, and new 
  961. QuickKeys cannot be added.  Selecting this option a second time 
  962. returns to the normal menu display.  Holding down BOTH mouse 
  963. buttons works the same as selecting this option (except in file 
  964. view, where BOTH buttons exits file view).  To view the list of 
  965. alternate QuickKeys, hold down Alternate or Control when 
  966. requesting the list (either Shift will also show the alternate 
  967. list, which makes some amountof sense since you need Shift with 
  968. the QuickKey to run a program in the alternate list).
  969.  
  970.  
  971. Menus - White/black (high res only)
  972.  
  973. On monochrome systems, Menus also contains White/black.  Click on 
  974. White/black to reverse the screen colors.  Hold down Alternate or 
  975. Control when you do this to keep the change for the current 
  976. picture (in memory only -- the picture's disk file is never 
  977. changed).  The color selected will be used for running programs.  
  978. If a picture is displayed, the color used to run programs is 
  979. displayed for a second or so (busy bee time) then the picture 
  980. color returns.
  981.  
  982.  
  983.  
  984. Color (color systems only)
  985.  
  986. The color menu lets you select which palette you want to see when 
  987. a program runs.  If no picture is loaded, palette changes affect 
  988. Runner's screen as well.  If a picture is loaded, a new palette is 
  989. displayed only briefly, then the picture's palette is restored.  
  990. This lets you use a reasonable palette for running programs while 
  991. displaying a picture that uses colors too disgusting for most 
  992. programs.  If you want to change the palette used for displaying 
  993. the picture, hold down the Alternate or Control key when selecting 
  994. a different palette.  You can always restore the picture's 
  995. original palette by selecting Picture, or by selecting another 
  996. palette without holding down Alternate.
  997.  
  998. Four palettes are available:
  999.  
  1000.      Initial - the palette loaded from Runner's configuration file
  1001.      Desktop - the colors in the desktop before Runner was started
  1002.      Picture - the colors from the last picture loaded into Runner
  1003.      Text    - the palette used for viewing files from the file
  1004.                selector
  1005.  
  1006. Runner uses the concept of the "Current Palette".  The Current 
  1007. Palette is the set of colors Runner switches to when running a 
  1008. program.  It is a copy of one of the other palettes (you can 
  1009. select which one from the menu bar -- it always starts out as a 
  1010. copy of the Initial Palette).  If no picture is loaded then the 
  1011. Current Palette is used for Runner's screen as well.  If a picture 
  1012. IS loaded, its palette normally overrides the Current Palette 
  1013. while the picture is visible, but the Current Palette is still 
  1014. used when running programs (you normally don't want your picture's 
  1015. colors when running your word processor).  If a palette is 
  1016. selected with Alternate or Control depressed, then the picture is 
  1017. displayed using the Current Palette.
  1018.  
  1019. The Current Palette in effect when you save a configuration file 
  1020. becomes the Initial Palette the next time that configuration file 
  1021. is loaded.  A separate Initial Palette is maintained for each 
  1022. resolution.  A single Text Palette is also saved in your config 
  1023. file and shared by all resolutions.
  1024.  
  1025. Runner Version 1.30 added support for changing the Current Palette 
  1026. from within Runner.  When viewing files from the file selector, 
  1027. only the text palette is changed.  From Runner's main screen, any 
  1028. of the palettes can be changed, but they must be made the Current 
  1029. Palette by selecting them in the Color menu.  To change colors 
  1030. within the Current Palette, simply select the color register you 
  1031. want to change on the keypad.
  1032. This diagram shows each key and     +------+------+------+------+
  1033. the number appearing on it, with    | ( 10 | ) 11 | / 12 | * 13 |
  1034. the color register (r0, r1 and      +------+------+------+------+
  1035. so on up through 15).  Background   | 7 r7 | 8 r8 | 9 r9 | - 14 |
  1036. is always register 0.  Text color   +------+------+------+------+
  1037. varies with resolution.  In high    | 4 r4 | 5 r5 | 6 r6 | + 15 |
  1038. res (mono) it's determined by       +------+------+------+------+
  1039. the background color (reg.0).  In   | 1 r1 | 2 r2 | 3 r3 |      |
  1040. medium res, register 3 controls     +------+------+------+ Enter|
  1041. text color, while 1 and 2 are for   |    0   r0   |      |      |
  1042. any other colors.  In low res,      +-------------+------+------+
  1043. register 15 (the + key) controls
  1044. text color.  Since only one text palette is used for all three 
  1045. resolutions, careful use of registers 0 and 3 should give you a 
  1046. readable combination (medium res is forced for file viewing from 
  1047. low res, so register 3 affects text color for both low and medium 
  1048. res when viewing files from the file selector).  Register 2 is 
  1049. left behind by some desk accessories when they exit; set register 
  1050. 2 to the same value as register 0 to avoid these holes in the 
  1051. screen.
  1052.  
  1053. Once you have selected a color register, press the R, G and B keys 
  1054. to change the color.  With Shift, this keys increase the Red, 
  1055. Green and Blue content.  Without Shift, they decrease it.  The 
  1056. color value is displayed (for example, 777 for a bright white).  
  1057. Increasing R, G, or B when it's already at 7 wraps it around to 0, 
  1058. and decreasing from 0 wraps around to 7.  Another color register 
  1059. can also be selected by pressing another keypad key.  When all the 
  1060. colors are set the way you like, press Enter or Return to accept 
  1061. them.  Press Esc instead if you don't want to keep the changes.  
  1062.  
  1063. Colors changed in this manner from Runner's main screen become the 
  1064. new Current Palette.  If you Save the current setup, these colors 
  1065. will be reloaded from RUNNER.CFG as the Initial Palette.  Colors 
  1066. changed when viewing a file from the file selector (or by pressing 
  1067. the Help key to view the help file) are remembered as the Text 
  1068. Palette.  If you saved your setup in RUNNER.CFG the Text Palette 
  1069. will have these new colors the next time you load Runner.
  1070.  
  1071. If you change the background picture palette, the new colors will 
  1072. be remembered in a picture configuration file on the next Save 
  1073. command.
  1074.  
  1075.  
  1076.  
  1077.  
  1078. The Main Screen
  1079.  
  1080. Once you have your program and menu lists, and any other 
  1081. attributes (time/date display, menu position, etc.) set up the way 
  1082. you want, you should save a configuration file.  Runner is fairly 
  1083. good at recovering from problems in programs it calls, such as too 
  1084. little memory or other errors, but problems within a called 
  1085. program may cause a system lockup or other problem preventing you 
  1086. from saving a configuration later.
  1087.  
  1088. Now you can try running programs and selecting menus.  Move the 
  1089. mouse over any program or menu name and left-click one time.  A 
  1090. program name will run the corresponding program.  A menu name will 
  1091. cause the contents of that menu to be displayed.  From a nested 
  1092. menu, click on the "Up One Level" line to return to the "parent" 
  1093. menu.  At the top level menu, this line says "Exit Runner".  An 
  1094. alert box makes sure you really do want to exit, so there is no 
  1095. danger of clicking on the Up One Level line too many times.  As a 
  1096. shortcut, a click of the right mouse button will take you 
  1097. immediately to the top level menu.
  1098.  
  1099. If you want to force a program to be run from Mini-Run, hold down 
  1100. Alternate or Control when you select it (or press Esc before you 
  1101. select it).
  1102.  
  1103.  
  1104.  
  1105.  
  1106. Keyboard Equivalents
  1107.  
  1108. Anything you can do with a mouse in Runner can be done without a 
  1109. mouse as well (in fact, there are some things you can't do with 
  1110. the mouse).  If your mouse should die, something in the ST lets 
  1111. you use the arrow keys to move the mouse pointer.  Press Alternate 
  1112. and the arrows to move in any direction.  Alternate and Insert are 
  1113. like pressing the left mouse button, and Alternate and Clr Home 
  1114. give a right mouse click.  For finer positioning use Shift 
  1115. Alternate and the arrow keys.
  1116.  
  1117. Runner improves on this basic idea: you can also use the up and 
  1118. down arrow keys without Alternate to move the mouse up an down in 
  1119. menu lists.  A right arrow selects a program to run or menu to 
  1120. open, and a left arrow moves up one menu level.  Insert acts like 
  1121. a left mouse click and Clr Home acts like a right mouse click.
  1122.  
  1123. In addition, Runner supports keyboard equivalents for almost every 
  1124. action.  In the GEM menu bar, there is always one upper case 
  1125. letter for each action.  Press that key as a shortcut:
  1126.  
  1127.        A - About RUNNER           U - Use accessories
  1128.        L - Load RUNNER.CFG        S - Save RUNNER.CFG
  1129.        I - Install applications   B - Background load/clear
  1130.        F - Fix RUNNER             P - add Program
  1131.        M - add Menu               C - Change prog/menu
  1132.        D - Drop prog/menu         R - Restore prog/menu
  1133.        Q - QuickKeys Show/Hide    W - White/black (mono)
  1134.        N - iNitial palette        K - desKtop palette
  1135.        G - backGround palette     T - Text palette
  1136.  
  1137.  
  1138. Several other keys are important to Runner (this info is available 
  1139. by pressing the Help key if RUNNER.HLP is in home directory):
  1140.  
  1141. Help - views the file RUNNER.HLP
  1142.  
  1143. Undo - quick exit from Runner - dialog box makes sure.
  1144.  
  1145. Esc - runs next program from Mini-Run.  Esc again turns this off.  
  1146.       The words "MINI_RUN" appear in upper right corner when enabled.
  1147.  
  1148. Tab - displays ALL programs and menus in list, regardless of 
  1149.       current resolution.  This lets you Change or Remove programs 
  1150.       without switching resolution.  Tab again to hide items for 
  1151.       wrong resolution.  The "registered" symbol (an "R" within a 
  1152.       circle) appears next to all programs or menus not normally 
  1153.       visible in the current resolution.  Think of the "R" as a 
  1154.       Resolution warning.
  1155.  
  1156. Backspace - switches display in upper right corner between 12-hour 
  1157.       time, 24-hour time, and current date (MM/DD/YY).  If Mini-Run 
  1158.       is enabled, date or time is replaced by "MINI_RUN".
  1159.  
  1160. Space - displays file selector.  Programs selected will be run, 
  1161.       other files will be viewed unless they are for an installed 
  1162.       application (then it will run and load the file).
  1163.  
  1164. Return - selects program to run or menu to open.
  1165.  
  1166. Keypad - 0,1,2,3,4,5,6,7,8,9,(,),/,*,-,+ select color registers
  1167.       to change.  Enter normally works as Return.
  1168.  
  1169. X - swaps previous path used in file selector with current path; 
  1170.       press X before going to file selector with Space.
  1171.  
  1172. ; - changes menu background space display.  Try this with a 
  1173.       picture displayed to see what it does.  Pressing ";" key 
  1174.       cycles between each of three display modes.
  1175.  
  1176. < - moves menu left one space; press rapidly (but do not hold 
  1177.       down) to move several spaces without waiting for redraw.
  1178.  
  1179. > - moves menu right one space (see "<").
  1180.  
  1181. / - centers menu on screen (default position).
  1182.  
  1183. H - hide text - lets you see whole picture.  Move mouse or press a 
  1184.       key (it will be ignored) to restore screen.
  1185.  
  1186. Z - zaps (hides) text and picture to blank out screen (see "H").
  1187.  
  1188.  
  1189. The E, J, O, V and Y keys are not currently used!
  1190.  
  1191.  
  1192.  
  1193.  
  1194. QuickKeys
  1195.  
  1196. You can assign up to eighteen keys to run programs you access 
  1197. frequently.  They are run exactly as if you had selected them from 
  1198. the menu (you can even force Mini-Run to run them by holding 
  1199. Control or Alternate as you press the QuickKey, or press Esc 
  1200. before pressing the QuickKey).  The F10 key is used to clear or 
  1201. assign a QuickKey.  Press F10, and a prompt asks you select a 
  1202. program.  Selecting a menu here will open the menu.  Once a 
  1203. program is selected, another prompt lists the QuickKeys still 
  1204. available.  If the program you selected had a QuickKey assigned, 
  1205. this will automatically clear the QuickKey from that program.
  1206.  
  1207. Now press a function key (F1 through F9) to assign a QuickKey to 
  1208. the program you selected.  Pressing F10 exits without assigning 
  1209. any keys (if, for example, you simply wanted to clear a key from a 
  1210. program).  Only unassigned keys can be selected.  If none are 
  1211. available, you'll have to clear (or drop) one somewhere else 
  1212. (press F10, select a program with a QuickKey you want to re-
  1213. assign, then press F10 again).
  1214.  
  1215. The menu list will be redrawn, and the program you selected will 
  1216. have a number (1-9) in front of it to remind you of the QuickKey 
  1217. assignment.  If you assigned F3 to Word Writer, for example, a "3" 
  1218. appears in the menu left of "Word Writer".  Press F3 to load and 
  1219. run Word Writer.
  1220.  
  1221. An alternate set of QuickKeys is available for a total of eighteen 
  1222. QuickKeys.  Press Shift-F10 to assign or clear from the alternate 
  1223. set, and press Shift-F1 through Shift-F9 to select the key and to 
  1224. run the assigned program.  The number (1-9) is displayed using the 
  1225. "computer font" numbers so you can tell which QuickKeys are which 
  1226. in your menus.
  1227.  
  1228. QuickKey assignments can be viewed in place of the normal Runner 
  1229. menus by selecting "QuickKeys show" from the "Menus" menu in the 
  1230. Gem menu bar, or by pressing the "Q" key, or by pressing BOTH 
  1231. mouse buttons.  Any of these actions return to the normal Runner 
  1232. menu lists, or you can select "Return to Menus" at the top of the 
  1233. QuickKeys list.  To view the alternate set, hold down Control or 
  1234. Alternate (or either Shift) when requesting the QuickKeys list.
  1235.  
  1236. When the QuickKeys list is displayed, you can run any of the 
  1237. programs as if you were in Runner's usual menus, with mouse or 
  1238. arrow keys and Return.  You can use the Change command to modify 
  1239. any program attributes.  Drop works differently: here it only 
  1240. clears a QuickKey assignment (the program dissappears from the 
  1241. QuickKeys list, but is not dropped from Runner's normal menus).  
  1242. Restore is disabled, and you cannot add programs or menus or 
  1243. assign QuickKeys here (how would you pick a program to assign?).  
  1244. Don't forget that programs set not to appear in menus in the 
  1245. current resolution will not appear in QuickKeys lists either, 
  1246. unless (as usual) you press the TAB key.
  1247.  
  1248.  
  1249.  
  1250. MINI-RUN
  1251.  
  1252. If you have MINI_RUN.TTP it should be placed in Runner's home 
  1253. directory (see above (way above)).  Mini-Run is easy to use!  
  1254. Simply press ESC in Runner before selecting a program to run (the 
  1255. words "MINI-RUN" appear in place of the clock display; press ESC 
  1256. again to clear them).  Or, you can hold down Alternate or Control 
  1257. when you select a program to run (but this doesn't work when 
  1258. running a program by selecting its data file).  You can also set a 
  1259. program to ALWAYS use Mini-Run when you first place it in a menu, 
  1260. or with the Menus-Change menu command.  For installed 
  1261. applications, hold down Alternate or Control when selecting the 
  1262. application from the file selector and an "(M)" appears in the 
  1263. installed application list indicating that program will use Mini-
  1264. Run.  You'll need to re-install the application to clear this.  
  1265. Note that installed applications are NOT related to other programs 
  1266. in Runner menus, even if the same program appears both places.  
  1267. Settings in the Program Description dialog box do not affect 
  1268. installed applications.
  1269.  
  1270. Mini-Run, when used, displaces Runner from memory and then loads 
  1271. whatever program you selected from Runner, giving it far more 
  1272. memory than possible from Runner alone.  If you load a large 
  1273. program from Mini-Run you will have time to read the version 
  1274. number and registration number of your copy (these are needed in 
  1275. any correspondence for registered users).  There are no other 
  1276. options for Mini-Run until you exit the application you loaded 
  1277. with it.  If it was a .TTP program, or you selected "Hold Screen" 
  1278. in the Program Description dialog box, then Mini-Run will prompt 
  1279. you to hit the SPACE key before returning to Runner.  Almost any 
  1280. key will work here, but pressing ESC will exit Mini-Run wihtout 
  1281. loading Runner.
  1282.  
  1283. When exiting other programs, if you hold down Alternate or 
  1284. Control, Mini-Run will not reload Runner and will exit back to the 
  1285. desktop.  For programs like Word Writer, where you can exit with a 
  1286. command such as Alternate-Q, you need to be quick to release the 
  1287. Alternate key or Mini-Run will act on it.
  1288.  
  1289. If you are running from floppy disks, Mini-Run will look for 
  1290. Runner in the same drive and directory from where it originally 
  1291. loaded.  If it can't find it, you'll get a chance to insert 
  1292. another disk and try again by pressing SPACE.  If you would rather 
  1293. exit here, press ESC.
  1294.  
  1295. If all this sounds complex, don't worry.  Mini-Run is very simple 
  1296. to use; you won't even notice it on a hard drive once you've used 
  1297. it a few times....
  1298.  
  1299.  
  1300.  
  1301. Other Stuff
  1302.  
  1303. Runner contains only one error message, and it's used no matter 
  1304. what the problem is.  This is better than crashing over small 
  1305. problems, and I felt it better than using lots of memory to 
  1306. diagnose and report various problems.  If you see the error 
  1307. message (something general like "Bad Drive, Path or Other Error"),
  1308. you can choose to return to Runner or exit to the desktop.
  1309.  
  1310.  
  1311. For some reason beyond my understanding, a program cannot be run 
  1312. from Runner if the program file is locked (set for Read Only).  If 
  1313. you have trouble loading a program, check for this using the 
  1314. File/Show Info function from the desktop.  Runner does NOT write 
  1315. to any files other than RUNNER.CFG and filename.CFx (picture 
  1316. configuration files where filename is the picture's name and 
  1317. x=1,2,3).  Trust me!
  1318.  
  1319.  
  1320. The template files, called GUIDE.PI1, GUIDE.PI2 and GUIDE.PI3 are 
  1321. ready to load into Degas Elite or any other program that accepts 
  1322. the Degas file format.  They mark where Runner displays its menus.  
  1323. The Grey areas are used by Runner (you can put stuff there, but 
  1324. Runner may cover it from time to time).  The black borders are not 
  1325. part of the area used by Runner.  The red lines (in GUIDE.PI3, the 
  1326. fuzzy markers) are used to verify the location of the lines.  A 
  1327. red line segment appears on each side of the black border lines.  
  1328. Runner should never cover more than the inside red line segment 
  1329. (or the inside edge of the fuzzy markers).  A calibration guide of 
  1330. sorts....  Color 3 is used for menu text in low res and 15 in 
  1331. medium res, and the opposite of color 0 is used in monochrome.
  1332.  
  1333. Special thanks to David Lindsley for some good ideas on this 
  1334. one....
  1335.  
  1336.  
  1337.  
  1338. One last note about GFA BASIC: I spent a great deal of time 
  1339. working around problems in detecting mouse clicks in the GEM menu 
  1340. bar rather then on the underlying screen (for example, when a pull 
  1341. down menu overlaps the title line, and you click on Add Menu but 
  1342. instead get the file selector box called by clicking on the title 
  1343. line).  GFA works reasonably well if everything is done inside a 
  1344. window and you rely on GFA's internal commands for detecting mouse 
  1345. presses, keypresses and so on.  The problem then is that GFA does 
  1346. all this too s-l-o-w-l-y to be usable, and has real problems 
  1347. registering mouse clicks consistently.  The language has a lot 
  1348. going for it, and is clearly up the required level of performance, 
  1349. but NOT if you go "by the book."  If anyone else out there has 
  1350. found better solutions (other than switching to C), please let me 
  1351. know.  I could cut out a lot of silly code that tracks the same 
  1352. things GEM must track internally.
  1353.  
  1354. If you have trouble with mouse clicks, you should try holding the 
  1355. mouse down a bit longer.  This clears up lots of problems like 
  1356. going to a new screen and having the mouse select the first thing 
  1357. it passes over, without a new mouse click.  Runner never uses 
  1358. double clicks, so slow down a bit and it all works better!
  1359.  
  1360. I completely gave up trying to tell when -exactly- to set or clear 
  1361. the inverse display of a program or menu name since GFA gives no 
  1362. way to tell if a GEM menu is displayed or not.  I tried putting in 
  1363. lots of delays.  They kept the screen cleaner but slowed the 
  1364. program too much and weren't completely or consistently effective 
  1365. either.  You'll have to live with the occaisional characters 
  1366. staying inverted when they shouldn't until I find a better way (or 
  1367. a better language).  Sorry, but I gave it my best shot.  Just run 
  1368. the mouse over them to clear them if you like.
  1369.  
  1370. That about wraps it up for Runner.  If you have any suggestions 
  1371. for additions, or find features you never use that could be 
  1372. removed, or something doesn't seem to work quite right, then 
  1373. contact me at the address at the top of this document.  If you 
  1374. use Runner, please send some $'s my way.  Remember, if you send 
  1375. a contribution of $10.00 or more, accompanied by a disk to send 
  1376. back to you and your return address, I will send you the Mini-Run 
  1377. program.
  1378.  
  1379. If you don't enjoy using your ST, you're not doing it right!
  1380.  
  1381.                                                   -- Dave Thorson
  1382.  
  1383. Products Mentioned (in no particular order):
  1384.   Atari Planetarium - Atari         Font Tricks - Analog Computing
  1385.   Laser C - Megamax, Inc.           Headstart - CodeHead Software
  1386.   Turbo ST - SofTrek                Do-It! - QMI
  1387.   Word Writer ST - Timeworks        ST Writer - Bruce Noonan
  1388.   Degas Elite / Degas - Batteries Included / Electronic Arts
  1389.   Universal Item Selector III - Application and Design Software
  1390.   GFA BASIC 3.0 - GFA Systemtechnik / Michtron / Antic Publishing / ?
  1391.   RealTime, Diablo, MidiMouse - Intelligent Music / Dr. T's
  1392.   Flash, CAD 3D, Spectrum 512 - Antic Publishing
  1393.   Colorburst 3000 - BeerysBit Software
  1394.  
  1395.